/**
 * 版权所有(C)，上海勾芒信息科技，2017，所有权利保留。
 * 
 * 项目名：	cards-web
 * 文件名：	WxAppQrcodeService.java
 * 模块说明：	
 * 修改历史：
 * 2017年4月21日 - Debenson - 创建。
 */
package cn.binarywang.wx.miniapp.api;

import java.io.File;

import me.chanjar.weixin.common.exception.WxErrorException;

/**
 * 小程序二维码相关服务。
 * 
 * @author Debenson
 * @since 0.1
 */
public interface WxMaQrcodeServiceEx extends WxMaQrcodeService {
  public static final String CREATE_QR_CODE_URL = "https://api.weixin.qq.com/cgi-bin/wxaapp/createwxaqrcode";
  public static final String CREATE_WXA_CODE_URL = "https://api.weixin.qq.com/wxa/getwxacode";

  /**
   * <pre>
   * 获取小程序页面二维码
   * 适用于需要的码数量较少的业务场景
   * 通过该接口，仅能生成已发布的小程序的二维码。
   * 可以在开发者工具预览时生成开发版的带参二维码。
   * 带参二维码只有 100000 个，请谨慎调用。
   * </pre>
   *
   * @param path
   *          不能为空，最大长度 128 字节
   * @param width
   *          默认430 二维码的宽度
   */
  File createQrcode(String path) throws WxErrorException;

  /**
   * 生成小程序码。
   * 
   * @param path
   *          小程序页面的路径。
   * @return
   * @throws WxErrorException
   */
  public File createWxacode(String path) throws WxErrorException;

}
